.. _cmcPmSxGetOptSyncOut:

cmcPmSxGetOptSyncOut
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

  VT_I4 cmcPmSxGetOptSyncOut([in] VT_I4 BoardID,  [in] VT_I4 NodeId, [in] VT_I4 Channel, 
  [out] VT_PI4 Mode, [out] VT_PI4 DoChan_local, [out] VT_PI4 DoLogic )  

DESCRIPTION
`````````````  

- cmcPmSxSetOptSyncOut()함수는 지정한 축의 각 속도 구간에서 고속 디지털 출력을 발생할 수 있도록 
합니다. 이 출력은 Machine Vision 등의 동기 시작 트리거(Trigger) 신호로 사용될 수 있습니다. 이 함수를 
통해 가속/정속/감속 구간의 시작과 끝에 동기되어 특정 디지털 출력을 발생시킬 수 있습니다. 
cmcPmSxGetOptSyncOut() 함수는 지정한 축의각 속도 구간에서 고속 디지털 출력의 발생에 대한 설정을 
반환합니다.  

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cmc 가 붙지 않습니다.

PARAMETER
`````````````
▶ BoardID : 사용자가 설정한 디바이스(보드) ID. 
 
▶ NodeId : 노드 번호. 노드 번호는 3부터 시작합니다. 
 
▶ Channel : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, 최대 
통합 축 개수 - 1 이하의 값을 축 번호로 설정할 수 있습니다. 
 
▶ Mode : cmcPmSxSetSyncOut 함수의 인자이며, 고속 디지털 출력 발생 모드를 설정합니다. 

.. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

    Value, Meaning
    0, 이 함수의 기능을 사용하지 않습니다.
    1, 가속 시작시에 출력을 발생 후 종료시에 출력을 종료합니다.
    2, 정속 시작시에 출력을 발생 후 종료시에 출력을 종료합니다.
    3, 감속 시작시에 출력을 발생 후 종료시에 출력을 종료합니다.

▶ Mode : cmcPmSxGetSyncOut 함수의 인자이며, 고속 디지털 출력 발생 모드를 설정합니다. 

.. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

    Value, Meaning
    0, 이 함수의 기능을 사용하지 않습니다.
    1, 가속 시작시에 출력을 발생 후 종료시에 출력을 종료합니다.
    2, 정속 시작시에 출력을 발생 후 종료시에 출력을 종료합니다.
    3, 감속 시작시에 출력을 발생 후 종료시에 출력을 종료합니다.
    

▶ DoChan_local : cmcSxSetOptSyncOut 함수의 인자이며, 범용 디지털 출력으로 사용할 디지털 출력 
채널을 설정합니다. 이 채널은 반드시 해당 모션 보드의 로컬(Local) 채널로 설정해야 합니다. 로컬(Local) 
채널이라는 것은 ceSDK 가 관리하는 전체 채널이 아닌 각 모션 보드내에서의 채널번호를 의미합니다. 즉, 
장치의 순서에 관계없이 해당 장치내에서의 디지털출력 채널만을 고려한 채널번호를 설정하여야 합니다. 
예를 들어서 COMI-LX504 제품의 경우에는 디지털출력 채널이 6 개 제공되므로 DoChannel_local 매개 
변수(媒介變數)에 사용될 수 있는 번호는 장치의 순서에 관계없이 0 ~ 5 가 되는 것입니다. 

▶ DoChan_local : cmcSxGetOptSyncOut 함수의 인자이며, 범용 디지털 출력으로 사용되는 디지털 출력 
채널을 반환합니다. 

▶ DoLogic : cmcSxSetOptSyncOut 함수의 인자이며, 디지털 출력 채널의 로직을 설정합니다.

.. csv-table::
  :widths: 10 90
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  0 또는cmcPM_LOGIC_A, A 접점 방식 => 평상시 Open, 감지되면 Close 되는 스위치 방식 
  1 또는cmcPM_LOGIC_B, B 접점 방식 => 평상시 Close, 감지되면 Open 되는 스위치 방식 

RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+